'\" t
.\"     Title: bugle-error
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: October 2007
.\"    Manual: Bugle user manual
.\"    Source: BUGLE 0.0.20150628
.\"  Language: English
.\"
.TH "BUGLE\-ERROR" "7" "October 2007" "BUGLE 0.0.20150628" "Bugle user manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
bugle-error \- detect errors in OpenGL calls
.SH "SYNOPSIS"
.sp
.nf
filterset error
.fi
.SH "DESCRIPTION"
.PP
This filter\-set does not take any visible action on its own, but provides a service to other filter\-sets\&. It calls
\fBglGetError\fR(3)
after every OpenGL call to detect OpenGL errors (it does not detect X errors)\&.
.PP
Usually you will not need to explicitly load this filter\-set; if you want to be informed of OpenGL errors, either use the
showerror
filterset, or
\fBgldb-gui\fR(1)\&. However, you may occasionally see the message
.sp
.if n \{\
.RS 4
.\}
.nf
An OpenGL error was detected but will be lost to the application\&.
.fi
.if n \{\
.RE
.\}
.sp
This means that
bugle\*(Aqs internal error\-checking code accidentally collected an error caused by one of your calls, and thus if your application later called
\fBglGetError\fR(3)
it would not be informed of the error\&. However, if you add the
error
filter\-set, it will catch the error first and your application will be correctly informed of the error\&.
.SH "BUGS"
.PP
Because the error reporting semantics of OpenGL are not completely defined (in particular, an implementation may choose how many error flags it has), it is impossible to guarantee that this filter\-set is completely transparent to the application\&. However, the first call to
\fBglGetError\fR(3)
always return an error, and in practice this is all that is necessary\&.
.SH "AUTHOR"
.PP
bugle
is written and maintained by
Bruce Merry\&.
.SH "SEE ALSO"
.PP
\fBbugle\fR(3),
\fBbugle-showerror\fR(7),
\fBbugle-trace\fR(7),
\fBglGetError\fR(3)
